'.\" t
.TH "lvmtool" "1M" "Jun 28, 2006" "1\&.2\&.0"
.SH NAME
lems.pl \- Linuxha.net Lems Daemon

.SH SYNOPSIS
.TS
l.
lems.pl \fB-A|--application\fP \fIapp\fP \fB--check\fP [\fB-V|--verbose\fP]
        [\fB--file\fP \fIF\fP] [\fB--config\fP \fIfile\fP] [\fB--clustercfg\fP \fIfile\fP]
        Check Configuration for specified application

lems.pl \fB-A|--application\fP \fIapp\fP [\fB-V|--verbose\fP] [\fB--detach\fP]
        [\fB--file\fP \fIF\fP] [\fB--config\fP \fIfile\fP] [\fB--clustercfg\fP \fIfile\fP]
        Start the Lems Daemon for the application

lems.pl \fB-?\fP
        Show brief usage information
.TE

.SH DESCRIPTION
The \fIlms.pl(1M)\fP is the daemon that each running application starts
to monitor the environment for that application. It is driven by
a configuration file - see \fIlems.xml(5)\fP for details. Typically the
configuration file will contain a file system synchronisation monitor
and one or more entries for process monitors relevant to the current
application.

.SH ARGUMENTS
Since the arguments include the action to be performed at least one of the
following arguments must be present;

.TP 4
.B *
--haslvm
.TP
.B *
--lvmtype
.TP
.B *
--hascmds
.TP
.B *
--vglist
.TP
.B *
--lvlist
.TP
.B *
--info
.TP
.B *
--lvrecreate
.TP
.B *
--resize
.TP
.B * 
--umount
.RE

Most arguments are related to particular actions, as now described.

.TP 8
.B --haslvm
If this node appears to be using LVM then the utility will print out "1" to
the standard output device. If no LVM appears available then "0" is printed
instead.
.TP
.B --lvmtype
A number "1" or "2" will be printed to the standard output device to indicate
that LVM version "1" or version "2" is in use. If this is called when LVM
is not available it will print "0" instead.
.TP
.B --hascmds
This will print "0" to the standard output device if the requried userspace
tools do not appear to be available. If instead they are available then "1"
will be printed instead.
.TP
.B --vglist
A list of available volume groups is printed to the standard output device,
each newline separated.
.TP
.B --lvlist
This requires that the \fB--vgname\fP is also passed, and it will return
a newline-separated list of logical volumes in the specified volume group.

If the \fB-v\fP or \fB--verbose\fP option is specified each logical volume
name will be followed by the state, size and whether the device is open
or not. The size is specified in KB, whilst the state will be "available"
or "unavailable".
.TP
.B --vgname
Used to indicate the volume group name to perform an action against (when
either listing logical volumes, creating new logical volumes, or changing
the size of an existing logical volume).
.TP
.B --lvname
Used to specified the name of a logical volume to perform the action 
against, (which may be a request for information, creation of a new
logical volume, or changing the size of an existing logical volume).
.TP
.B --info
Used to return the state, size and whether the specified logical volume
is open. This argument requires that the \fB--lvname\fP and \fB--vgname\fP
arguments are specified.
.TP
.B --size
Indicates the size of a device to create, or a device to change the
size of. The size is given in Kb rather than Mb - so 1Gb would be specified
as 1048576.
.TP
.B --lvcreate
Used to create a new logical volume. The arguments \fB--lvname\fP,
\fB--vgname\fP and \fB--size\fP must all be specified to ensure the
volume in question gets created.
.TP
.B --resize
Used to change the size of an existing logical volume. The arguments 
\fB--lvname\fP, \fB--vgname\fP and \fB--size\fP must all be specified 
to ensure the volume in question gets changed in size (either larger or 
smaller).
.TP
.B --umount
Used to ensure if a specified logical volume (as defined by the mandatory
\fB--lvname\fP and \fB--vgname\fP arguments) is used as a mounted file system
it is un-mounted.

.SH EXIT STATUS
The \fIlvmtool(1M)\fP utility typically only makes use of two exit codes:

.TP 4
0
The requested operation has been completed successfully.
.TP
1
An error occurred whilst trying to perform the specified operation.

.SH SEE ALSO
.TS
l l.
lvcreate(1)	- Create a logical volume
vgcreate(1)	- Create a volume group
pvcreate(1)	- Create a physical volume
vgchange(1)	- Change volume group status
lvchange(1)	- Change logical volume characteristics
.TE

.SH AUTHOR
The \fIlvmtool(1M)\fP utility was written by Simon Edwards, 2003 - 2006. The
author can be contacted via the website mentioned below.

.SH AVAILABILITY
This software is freely available from the Linuxha website - please see
\fBhttp://www.linuxha.net\fP for more details.

.SH WARRANTY
This is Open Source Software is per the GNU GPL. It is free to use and
distribute but \fIcomes with no warranty whatsoever\fP. For more information
on the license please see \fBwww.gnu.org/copyleft/gpl.html\fP.

